home *** CD-ROM | disk | FTP | other *** search
/ Aminet 45 / Aminet 45 (2001)(GTI - Schatztruhe)[!][Oct 2001].iso / Aminet / game / role / ldmud-3.2-bin.lha / mud / doc / efun / rename < prev    next >
Text File  |  2001-04-06  |  972b  |  27 lines
  1. SYNOPSIS
  2.         int rename(string from, string to)
  3.  
  4. DESCRIPTION
  5.  
  6.         The efun rename() will move from to the new name to. If from
  7.         is a file, then to may be either a file or a directory. If
  8.         from is a directory, then to has to be a directory. If to
  9.         exists and is a directory, then from will be placed in that
  10.         directory and keep its original name.
  11.         
  12.         You must have write permission for from to rename the file.
  13.         
  14.         It is only possible to change name of a directory within a
  15.         directory on machines running System V, i.e. it is not
  16.         possible to move to another directory. It is not possible to
  17.         move a directory across filesystems on any system.
  18.         
  19.         On successfull completion rename() will return 0. If any error
  20.         occurs 1 is returned.
  21.  
  22. EXAMPLE
  23.         rename("/players/wizard/obj.c", "/players/wizard/newobj.c");
  24.  
  25. SEE ALSO
  26.         copy_file(E), mkdir(E), rmdir(E), rm(E)
  27.